Skip to main content

Reschedule Appointment Workflow

Bookadoc integrates with DrChrono to allow patients to reschedule appointments with healthcare providers.

Reschedule the Appointment​

Bookadoc sends a request to DrChrono to reschedule the appointment.

API Endpoint​

PUT /api/appointments/{appointmentId}

Example Request​

PUT /api/appointments/1861676

Request Payload​

{
  "doctor": 123456,
  "exam_room": 0,
  "office": 234567,
  "patient": 345678900,
  "scheduled_time": "2025-02-21T16:00",
  "duration": 30
}

The duration field is only required if appointment profile id has not been provided. The request payload properties above are required before you can book an appointment.

To get the doctor id for the POST request to be made, use the API endpoint below:

Doctor API Endpoint​

GET /api/doctors

To get the exam_room index for the POST request to be made. It is usually returned after a GET request has been made with Office API Endpoint

To get the patient id for the POST request to be made, use the API endpoint below:

Patient API Endpoint​

GET /api/patients

Also the duration integer property value represents the duration for the booking in minutes.

Response Example​

204 No Content

If the request is successful, the appointment is updated in DrChrono, and Bookadoc records the appointment details.

Error Handling​

If an error occurs at any step, Bookadoc handles it gracefully and provides feedback to the user.

Common Errors & Resolutions​

Error CodeDescriptionResolution
400 Bad RequestMissing or invalid input fieldsEnsure all required fields are provided
409 ConflictAppointment slot already bookedPrompt user to select another slot
500 Internal Server ErrorAthenaHealth API issueRetry the request after some time

Conclusion​

The booking appointment workflow ensures that Bookadoc synchronizes seamlessly with DrChrono, allowing patients to reschedule appointments while keeping providers' schedules up to date. By validating data, checking availability, and handling errors effectively, Bookadoc enhances the booking experience for both patients and providers.